TextField.setTextFormat()

Доступность

Flash Player 6.

Usage

my_txt.setTextFormat (textFormat:TextFormat) : Void
my_txt.setTextFormat (index:Number, textFormat:TextFormat) : Void
my_txt.setTextFormat (beginIndex:Number, endIndex:Number, textFormat:TextFormat) : Void

Синтаксис

textFormat Экземпляр объекта TextFormat, который содержит символ и параграф форматируемой информации.

index Целое число, определяющее символ внутри my_txt.

beginIndex  Целое число, определяющее символ, с которого начинается форматирование текста

endIndex  Целое число, определяющее первый символ после форматированного блока.

Возвращает

Ничего.

Описание

Метод; устанавливает форматирование определенного диапазона символов в поле. textFormat должен быть объектом TextFormat который определяет желаемые изменения форматирования текста. Только не установленные в null свойства применяются к текстовому полю. По умолчанию, все свойства вновь созданного объекта TextFormat установлены в null. Существует два типа форматирования информации в объекте TextFormat: форматирование на уровне символов, и форматирование на уровне параграфов. Каждый символ в текстовом поле может иметь его собственные установки форматирования, такие как имя шрифта, размер шрифта, bold, и italic.

Формат первого символа в абзаце производит форматирование для всего абзаца. Пример форматирования абзаца - выравнивание по левому, правому краю и по центру.

Метод setTextFormat() применяется для изменения форматирования отдельных символов, ряда символов, или тела введенного текста в текстовом поле.

Синтаксис 1: Применяет свойства textFormat ко всему тексту в поле.

Синтаксис 2: Применяет свойства textFormat к символу определяемому index.

Синтаксис 3: Применяет свойства textFormat к блоку символов текста от beginIndex до endIndex.

Запомните что любой текст введенный вручную пользователем, или удаленный посредством TextField.replaceSel(), принимает форматирование текста по умолчанию для нового текста. Для установки форматирования для нового текста, используйте TextField.setNewTextFormat().

Пример

Следующий пример устанавливает форматирование для двух различных строк. Метод setTextFormat() вызывается и применяется для текстового поля my_txt.

var format1_fmt:TextFormat = new TextFormat();
format1_fmt.font = "Arial";
var format2_fmt:TextFormat = new TextFormat();
format2_fmt.font = "Courier";

var string1:String = "Sample string number one."+newline;
var string2:String = "Sample string number two."+newline;

this.createTextField("my_txt", this.getNextHighestDepth(), 0, 0, 300, 200);
my_txt.multiline = true;
my_txt.wordWrap = true;
my_txt.text = string1;
var firstIndex:Number = my_txt.length;
my_txt.text += string2;
var secondIndex:Number = my_txt.length;

my_txt.setTextFormat(0, firstIndex, format1_fmt);
my_txt.setTextFormat(firstIndex, secondIndex, format2_fmt);

См. также

TextField.setNewTextFormat(), TextFormat class